home *** CD-ROM | disk | FTP | other *** search
/ Personal Computer World 2009 February / PCWFEB09.iso / Software / Linux / Kubuntu 8.10 / kubuntu-8.10-desktop-i386.iso / casper / filesystem.squashfs / usr / share / doc / ppp / README.pwfd < prev    next >
Text File  |  2002-02-11  |  4KB  |  175 lines
  1.  
  2.     Support to pass the password via a pipe to the pppd
  3.     ---------------------------------------------------
  4.  
  5.     Arvin Schnell <arvin@suse.de>
  6.     2002-02-08
  7.  
  8.  
  9. 1. Introduction
  10. ---------------
  11.  
  12. Normally programs like wvdial or kppp read the online password from their
  13. config file and store them in the pap- and chap-secrets before they start the
  14. pppd and remove them afterwards. Sure they need special privileges to do so.
  15.  
  16. The passwordfd feature offers a simpler and more secure solution. The program
  17. that starts the pppd opens a pipe and writes the password into it. The pppd
  18. simply reads the password from that pipe.
  19.  
  20. This methods is used for quiet a while on SuSE Linux by the programs wvdial,
  21. kppp and smpppd.
  22.  
  23.  
  24. 2. Example
  25. ----------
  26.  
  27. Here is a short C program that uses the passwordfd feature. It starts the pppd
  28. to buildup a pppoe connection.
  29.  
  30.  
  31. --snip--
  32.  
  33. #include <stdio.h>
  34. #include <stdlib.h>
  35. #include <unistd.h>
  36. #include <signal.h>
  37. #include <string.h>
  38. #include <paths.h>
  39.  
  40. #ifndef _PATH_PPPD
  41. #define _PATH_PPPD "/usr/sbin/pppd"
  42. #endif
  43.  
  44.  
  45. // Of course these values can be read from a configuration file or
  46. // entered in a graphical dialog.
  47. char *device = "eth0";
  48. char *username = "1122334455661122334455660001@t-online.de";
  49. char *password = "hello";
  50.  
  51. pid_t pid = 0;
  52.  
  53.  
  54. void
  55. sigproc (int src)
  56. {
  57.     fprintf (stderr, "Sending signal %d to pid %d\n", src, pid);
  58.     kill (pid, src);
  59.     exit (EXIT_SUCCESS);
  60. }
  61.  
  62.  
  63. void
  64. sigchild (int src)
  65. {
  66.     fprintf (stderr, "Daemon died\n");
  67.     exit (EXIT_SUCCESS);
  68. }
  69.  
  70.  
  71. int
  72. start_pppd ()
  73. {
  74.     signal (SIGINT, &sigproc);
  75.     signal (SIGTERM, &sigproc);
  76.     signal (SIGCHLD, &sigchild);
  77.  
  78.     pid = fork ();
  79.     if (pid < 0) {
  80.     fprintf (stderr, "unable to fork() for pppd: %m\n");
  81.     return 0;
  82.     }
  83.  
  84.     if (pid == 0) {
  85.  
  86.     int i, pppd_argc = 0;
  87.     char *pppd_argv[20];
  88.     char buffer[32] = "";
  89.     int pppd_passwdfd[2];
  90.  
  91.     for (i = 0; i < 20; i++)
  92.         pppd_argv[i] = NULL;
  93.  
  94.     pppd_argv[pppd_argc++] = "pppd";
  95.  
  96.     pppd_argv[pppd_argc++] = "call";
  97.     pppd_argv[pppd_argc++] = "pwfd-test";
  98.  
  99.     // The device must be after the call, since the call loads the plugin.
  100.     pppd_argv[pppd_argc++] = device;
  101.  
  102.     pppd_argv[pppd_argc++] = "user";
  103.     pppd_argv[pppd_argc++] = username;
  104.  
  105.     // Open a pipe to pass the password to pppd.
  106.     if (pipe (pppd_passwdfd) == -1) {
  107.         fprintf (stderr, "pipe failed: %m\n");
  108.         exit (EXIT_FAILURE);
  109.     }
  110.  
  111.     // Of course this only works it the password is shorter
  112.     // than the pipe buffer. Otherwise you have to fork to
  113.     // prevent that your main program blocks.
  114.     write (pppd_passwdfd[1], password, strlen (password));
  115.     close (pppd_passwdfd[1]);
  116.  
  117.     // Tell the pppd to read the password from the fd.
  118.     pppd_argv[pppd_argc++] = "passwordfd";
  119.     snprintf (buffer, 32, "%d", pppd_passwdfd[0]);
  120.     pppd_argv[pppd_argc++] = buffer;
  121.  
  122.     if (execv (_PATH_PPPD, (char **) pppd_argv) < 0) {
  123.         fprintf (stderr, "cannot execl %s: %m\n", _PATH_PPPD);
  124.         exit (EXIT_FAILURE);
  125.     }
  126.     }
  127.  
  128.     pause ();
  129.  
  130.     return 1;
  131. }
  132.  
  133.  
  134. int
  135. main (int argc, char **argv)
  136. {
  137.     if (start_pppd ())
  138.     exit (EXIT_SUCCESS);
  139.  
  140.     exit (EXIT_FAILURE);
  141. }
  142.  
  143. ---snip---
  144.  
  145.  
  146. Copy this file to /etc/ppp/peers/pwfd-test. The plugins can't be loaded on the
  147. command line (unless you are root) since the plugin option is privileged.
  148.  
  149.  
  150. ---snip---
  151.  
  152. #
  153. # PPPoE plugin for kernel 2.4
  154. #
  155. plugin pppoe.so
  156.  
  157. #
  158. # This plugin enables us to pipe the password to pppd, thus we don't have
  159. # to fiddle with pap-secrets and chap-secrets. The user is also passed
  160. # on the command line.
  161. #
  162. plugin passwordfd.so
  163.  
  164. noauth
  165. usepeerdns
  166. defaultroute
  167. hide-password
  168. nodetach
  169. nopcomp
  170. novjccomp
  171. noccp
  172.  
  173. ---snip---
  174.  
  175.